========================================================================
  Dismemberment Gore - GTA V Enhanced
  Work-in-Progress / BETA  |  by TeamHimes  |  100% FREE
========================================================================

A gore / dismemberment overhaul for GTA V Enhanced: blow off heads and limbs,
with pressurized directional blood, gore caps, an auto-headshot option and a
configurable kill counter.

===  WORK IN PROGRESS / BETA  ===
Everything listed above works. Full TORSO dismemberment is still in development
(it needs an Enhanced-engine fix) and will arrive in a future update. Head and
limb dismemberment are fully functional. This mod is - and always will be - 100% free.

------------------------------------------------------------------------
  FEATURES
------------------------------------------------------------------------
- Multi-dismemberment - blow off heads and limbs; real gore caps cover the wound, no ugly stretched vertices.
- Adaptive stumps - every wound is fitted to the victim: stump position is computed from the ped's actual skeleton, women get slimmer stump models, heavy peds get bigger ones, and hip stumps follow the direction of the lost leg.
- Directional blood - pressurized blood fountains burst from the wound, with delayed droplets and configurable intensity.
- Auto-Headshot (optional) - chance-based automatic headshots; set the percentage and choose all weapons or pistols only.
- Kill Counter HUD - on-screen kill counter, movable, with color/size options and an optional vehicle-kills toggle.
- Multi-language menu - English, Italian, Spanish, German, French.
- Fully configurable - in-game menu (PageUp) and Dismemberment.ini: blood, weapons, auto-headshot, HUD and more.
- Stable - handle-based tracking, hardened against the classic despawn/pool-reuse crashes.

------------------------------------------------------------------------
  REQUIREMENTS
------------------------------------------------------------------------
- GTA V ENHANCED (Singleplayer)
- Script Hook V .............. by Alexander Blade
- Script Hook V .NET Enhanced  by Chiheb-Bacha (needs .NET Framework 4.8 + Visual C++ 2019 x64 redistributable)

------------------------------------------------------------------------
  INSTALLATION
------------------------------------------------------------------------

1. Install Script Hook V and Script Hook V .NET Enhanced.

Copy
DismembermentASI.asi 
into 
your GTA V root folder (next to GTA5_Enhanced.exe)

2. Open your GTA V scripts folder

Go to your GTA V main directory and open:

scripts

Create the folder if it does not already exist.

3. Copy the script files

Copy the following files into your scripts folder:

scripts/Dismemberment.dll
scripts/DismembermentWeapons.cfg
scripts/DismembermentSounds

4.Copy the mod folder:

dismemberment
to:
mods\update\x64\dlcpacks
or, depending on your setup, to:
onigiri\dlcpacks

5. Edit dlclist.xml

Using OpenIV, go to:
Grand Theft Auto V Enhanced\mods\update\update.rpf\common\data
Open:
dlclist.xml
Add this line:
<Item>dlcpacks:/dismemberment/</Item>
Save the file.
Alternative onigiri path:
Grand Theft Auto V Enhanced\onigiri\common\data

6. Install textures with OpenIV

This step is required for the texture-based crosshairs.

Open OpenIV, enable Edit Mode, and install:

deadeye.ytd

to:

mods\update\update.rpf\x64\textures\script_txds.rpf

NVE Users
put the ONIGIRI folder where script_txds.rpf is included with my dismember.ytd into 
\Rockstar Games\Grand Theft Auto V Enhanced\
NOTE: if you allready got my deadeye mod and use Onigiri, you dont need it, cause its already included in the script_txds.rpf

7. Start the game

On first launch, the mod automatically creates:

scripts/Dismemberment.ini
------------------------------------------------------------------------
  USAGE & CONFIG
------------------------------------------------------------------------
- It works automatically: kill NPCs with the configured weapons and they come apart.
- PageUp - open the in-game configuration menu (rebindable in Dismemberment.ini).
- Configure blood intensity, auto-headshot chance, weapons, kill counter, language and more,
  either in the menu or by editing scripts/Dismemberment.ini.

------------------------------------------------------------------------
  KNOWN LIMITATIONS (please read before reporting)
------------------------------------------------------------------------
- Torso dismemberment is not enabled yet - it is coming in a future update.
  Head and limb dismemberment work fully.
- This is a BETA - if something breaks, please report it (with your game version).
- No effect / crashes after a GTA update: update Script Hook V and Script Hook V .NET
  Enhanced to versions matching your current game build, then relaunch.

------------------------------------------------------------------------
  CREDITS
------------------------------------------------------------------------
- Original dismemberment concept & script . jedijosh920
- Low-level hide-hook technique ........... CamxxCore / ClearEdge (0x-FADED)
- Gore models ............................. SpringBunny
- Models, textures & testing .............. Ze Krush
- Enhanced port & this mod ................ TeamHimes
- Beta testing ............................ Schakusa, DieBruderschaft
- Video / Screens...........................Schakusa, DieBruderschaft
- Script Hook V ........................... Alexander Blade
- Script Hook V .NET Enhanced ............. Chiheb-Bacha
- Libraries ............................... MinHook (Tsuda Kageyu, BSD-2-Clause)

With kind permission of ClearEdge and Chiheb-Bacha!

The open-source code will be released once the mod is finished... Many thanks again to ClearEdge and Chiheb! Awesome.

------------------------------------------------------------------------
  SUPPORT (optional)
------------------------------------------------------------------------
This mod is completely free and always will be - nothing is ever locked.
If you enjoy it and want to support future work, tips are welcome (optional):
   Ko-fi:   ko-fi.com/teamhimes

This is a fan-made mod and is not affiliated with or endorsed by Rockstar Games.
========================================================================
